Note

Description

Adds a new base44 logs command that provides unified log viewing for Base44 applications. The command fetches and displays both app-level audit logs (entity operations, function calls, auth events, user management) and function execution logs in a single view. Users can filter by specific functions, log levels, time ranges, and export results as JSON for programmatic access.

Related Issue

None

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)
• Other (please describe):

Changes Made

• Added base44 logs command with comprehensive filtering options (--function, --level, --since, --until, --limit, --order, --json)
• Implemented unified log display combining app audit logs and function execution logs
• Created core logs module (src/core/logs/) with API client, Zod schemas, and workspace ID resolution
• Added function logs API support (src/core/resources/function/api.ts, fetchFunctionLogs())
• Refactored functions command structure to use parent command pattern (consolidation)
• Added comprehensive test coverage with 11+ test cases for logs command and functions logs
• Extended testkit with API mocking for audit logs and function logs endpoints
• Implemented human-readable table formatting with color-coded log levels and timestamps

Testing

• I have tested these changes locally
• I have added/updated tests as needed
• All tests pass (npm test)

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation (if applicable)
• My changes generate no new warnings
• I have updated AGENTS.md if I made architectural changes

Additional Notes

Command Usage:

base44 logs                           # Show all app + function logs
base44 logs --function my-func        # Show logs for specific function(s)
base44 logs --level error             # Filter by log level
base44 logs --since 2024-01-01        # Filter by time range
base44 logs --json                    # Output as JSON

Architecture:

• Follows established CLI patterns (factory functions, CLIContext injection, runCommand/runTask wrappers)
• Uses structured error handling with InvalidInputError for validation
• Implements Zod schemas for API response validation
• Audit logs require workspace ID lookup (getWorkspaceId()) before fetching
• Function logs are fetched per-function and merged with audit logs for unified view

_{🤖 Generated by Claude | 2026-02-05 09:45 UTC}